home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 98 / Skunkware 98.iso / src / net / bind-contrib.tar.gz / bind-contrib.tar / contrib / tic / README < prev    next >
Text File  |  1996-10-25  |  4KB  |  84 lines
  1. # Copyright (c) 1992 by Texas Internet Consulting
  2. # This code may be freely copied and used so long as this
  3. # copyright notice is attached.  This code may not be sold
  4. # without the express written permission of Texas Internet Consulting.
  5. # Texas Internet Consulting makes no warranty as to the correctness
  6. # nor the applicability of this code for any purpose.
  7.  
  8. Generic host configuration files.
  9.  
  10. This is a brief overview of a set of utilities used to manage
  11. host files when running DNS or NIS nameservice or both.
  12.  
  13. File description:
  14.  
  15. README - this file
  16. etc.named - files installed in /etc/named
  17. gendns - shell script to generate DNS tables
  18. genstatic - shell script to generate static host file
  19. make_rev - automatically creates the reverse DNS map
  20. poke_ns.c - C program to help manage DNS servers
  21. readinfo - shell script to extract fields from hst files
  22. updatehosts - shell scrip to automate host update
  23.  
  24. This host database system organizes host information in a set of
  25. flat tables.  All host updates are made in these tables.  From these
  26. tables both the static host table and the DNS database files are created.
  27. This eliminates potential errors caused by having to maintain two sets of
  28. host tables.
  29.  
  30. The static host table is used to update NIS maps, if you run NIS.  It can
  31. also be used on machines which may not have DNS or NIS support.
  32.  
  33. Install the scripts in /usr/local/etc.  Compile and install poke_ns in
  34. /usr/local/etc making it setuid to root, but only executable by the group
  35. of users which will be maintainingg the host database.  Do not make it
  36. executable by everyone.  Check the define NAMED and be sure it points to
  37. the pathname for your nameserver.
  38.  
  39. The next step is to install the files in etc.named in the /etc/named
  40. directory or the directory where the DNS database files will be maintained.
  41.  
  42. Now populate the host database files.  These files are organized like a
  43. relational database and consist of several files.  They are all under SCCS
  44. control and must be checked out to be populated.  Be sure and check the
  45. files back in under SCCS before continuing.
  46.  
  47. hosts.main - the main host file.  Required fields are the host and IP
  48. address field.  Note the #FIELDS line.  This describes the fields to the
  49. readinfo script which extracts particular fields from the host.* files.
  50. Each field is described by its fieldname, followed by an optional prefix=,
  51. suffix=, or no= descriptor.  The prefix= and suffix= describe what will be
  52. prepended or appended to the field value when readinfo outputs the field.
  53. For host names the suffix is equal to the default domain.  For host
  54. addresses the prefix is equal to the network number.  This facility is a
  55. useful shorthand.  The no= field gives a character which says to display
  56. the host value as given and ignore any prefix or suffix.  For example if
  57. your default domain is tic.com and you have a host named tic.com enter it
  58. in the file as @tic.com@.
  59.  
  60. hosts.cname - host alias file.  This has two fields the real host name
  61. followed an alias for the host.  If a host has more than a single alias,
  62. renteer the host name followed by the second alias.
  63.  
  64. hosts.mx - DNS MX information is entered here.  This file has three fields:
  65. the domain name to MX for, the priority of the MX record and the host to
  66. forward mail to for this domain.
  67.  
  68. The other hosts.* and remaining files are helper files
  69. for creating the static host tables and DNS files.  No data needs to be entered into them.
  70.  
  71. Create a file in nisservers of the host names for NIS servers for doing
  72. host lookups.  If you have no NIS servers performing this function do not
  73. create this file.
  74.  
  75. Run the command updatehosts -u.  This will generate the DNS tables and
  76. start the DNS server or cause the currently running server to reload its
  77. data files.  If you are replacing an existing DNS server it is best to
  78. bring it down first  before typing this command.  When you update the host
  79. files in the future, type updatehosts followed by the names of the files
  80. which need to be updated. e.g. updatehosts hosts.main.  This can be done in
  81. any directory.  Updatehosts knows how to find the files.  The -u option is
  82. used when you want to update the server without modifying any files or you
  83. modified the files by manually running SCCS.
  84.